Do Class Comments Aid Java Program Understanding?
نویسندگان
چکیده
1 Eriko Nurvitadhi, Oregon State University, Corvallis, OR 97330 [email protected] 2 Wing Wah Leung, Oregon State University, Corvallis, OR 97330 [email protected] 3 Curtis Cook, Oregon State University, Corvallis, OR 97330 [email protected] Abstract This paper describes an experiment that investigates the effects of class and method comments on Java program understanding among beginning programmers. Each of the 103 students from CS1 class at Oregon State University was given one of four versions (No comments, only method comments, only class comments, and both method and class comments) of a Java database program and answered questions about the program. The results indicated that method comments do increase lowlevel program understanding, while class comments did not increase high-level understanding. This raises questions about the role of class comments in Object-Oriented programs, as well as the kind of commenting guidelines that should be used in teaching CS1 classes.
منابع مشابه
Animated UML as a 3d-illustration for teaching OOP
The classical view of a register-based abstract machine is a barrier for understanding the execution of object-oriented programs. We visualize program execution based on the object-oriented paradigm with its objects and the message flows between them. For this we propose a visualisation for intuitive understanding of object-oriented based program executions. Three dimensional animated illustrat...
متن کاملAn Empirical Study of Java Dynamic Call Graph Extractors
A dynamic call graph is the invocation relation that represents a specific set of runtime executions of a program. Dynamic call graph extraction is a typical application of dynamic analysis to aid compiler optimization, performance analysis, program understanding, etc. In this paper, we empirically compare the results of nine Java dynamic call graph extractors quantitatively and qualitatively. ...
متن کاملFast portable orthogonally persistent Java
A powerful feature of the Java programming language is its user-definable class loading policy, which when combined with the namespace independence between class loaders, allows portable implementation of semi-dynamic program transformations. Such transformations can be used for a range of purposes, including optimization and semantic extension. In this paper we present a framework for semantic...
متن کاملPractical Exception Specifications
Exception specifications can aid in the tasks of writing correct exception handlers and understanding exceptional control flow, but current exception specification systems are impractical in a number of ways. In particular, they are too low-level, too heavyweight, and do not provide adequate support for describing exception policies. We propose a novel and lightweight exception specification sy...
متن کاملTailored Compression of Java Class Files
The Java programming language and its implementation using a Java Virtual Machine (JVM) have greatly simplified the task of developing web-based application programs. In this and in other roles, Java has been a runaway success. When a Java program is compiled, it is translated into a collection of class files. Each class file contains a variety of components, including instructions for the JVM ...
متن کامل